home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
bbs_door
/
high200.zip
/
HIGHLAND.DOC
< prev
next >
Wrap
Text File
|
1996-05-17
|
65KB
|
1,922 lines
───────────────────────────────────────────────────────────────────────────
▓▒░ ▓▒░ ▓▒░ ▒░▓▓▒ ▓▓▒ ▓▒░ ▓▒░ ▒░▓▓▒ ▒░▓▓▒ ▓▒░▓▓▒ ░░▓▓▒ ▒░▓▓▒
▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░
▒░░▒▒░░ ▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░
▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░
░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒
░░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒
░▒▓ ░▒▓ ░▒▓ ▒▓▓░▒ ░▒▓ ░▒▓ ░▒▓▓▓▒░ ░▒▓ ░▒▓ ░▒▓ ░▒▓ ░▒▓▓░▒ ▒▓▓░▒ ░▒▓
───────────────────────────────────────────────────────────────────────────
T h e o n l y O N E l i n e r
──────────────────────────────────────────────────
Written By: Steven Holme
Copyright (c) 1995, 96 Fonty Technologies (UK) Inc
All Rights Reserved
──────────────────────────────────────────────────
Version 2.00
Released: 17 May 1996
───────────────────────────────────────────────────────────────────────────
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
Table of Contents
1 Introduction......................................................03
1.1 What is HiGHLANDER?...........................................03
1.2 Features......................................................03
1.3 Requirements..................................................04
1.4 Testing.......................................................04
1.5 License Agreement.............................................05
1.6 Disclaimer....................................................06
1.7 Guarentee.....................................................06
1.8 Trademarks....................................................06
2 Registering.......................................................07
3 Distribution Archive..............................................08
4 Additional Files..................................................09
5 Installation......................................................09
5.1 Quick Installation............................................09
5.2 Command Line Parameters.......................................10
5.2.1 BBS Parameters..........................................10
5.2.2 Communications Parameters...............................10
5.2.3 HiGHLANDER Parameters...................................11
5.2.3.1 Standard Parameters.............................11
5.2.3.2 Bulletin Parameters.............................11
5.3 The Configuration File........................................12
5.3.1 BBS Commands............................................12
5.3.2 Communications Commands.................................12
5.3.3 HiGHLANDER Commands.....................................13
5.3.3.1 Standard Commands...............................13
5.3.3.2 Security Commands...............................19
5.3.3.3 Menu Commands...................................20
5.3.3.4 Bulletin Commands...............................22
5.3.3.5 Protocol Commands...............................25
5.3.4 A Note On The Colour Parameters.........................25
5.5 InterBBS Configuration Files..................................26
5.4 Maintanence...................................................27
6 Future Versions...................................................28
7 Credits...........................................................28
7.1 Thanks........................................................29
7.2 Contributions.................................................29
7.3 The Beta Testers..............................................30
7.4 InterBBS Leagues..............................................30
8 Support...........................................................31
8.1 By Post.......................................................31
8.2 By BBS........................................................31
8.3 By E-Mail.....................................................31
9 Contributions.....................................................32
10 And On A Last Note...............................................32
──────────────────────────────────────────────────────────────────────
Page 2
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
1 Introduction
1.1 What is HiGHLANDER?
HiGHLANDER is a 'oneliner' door program which should work with most
BBS systems. For those of you that don't know what a 'oneliner' is: it
is simply a message, comment or quote which is oneline in size.
Unlike most other 'oneliner' type programs HiGHLANDER is extremely
easy to install and configurable to your personnal needs.
HiGHLANDER was written to provide a decent oneliner door for The Fonty
Towers BBS. Various BBSes were scanned for such a door and there was
no success in finding a really good oneliner. Most oneliner doors
where just not configurable enough.
1.2 Features
In the following list of features, the {+} symbol indicates a
registered only feature.
HiGHLANDER includes the following list of features:
■ Displays the oneliners.
■ Displays the writers of the oneliners.
■ Displays the BBS origin of the oneliners.
■ Displays the date and time of the oneliners.
■ Displays top writers chart.
■ Top writer and non-writer statistics.
■ User downloadable statistics files.
■ Easy to use configuration files.
■ Sysop configurable main screen for personnal look and feel.
■ Sysop configurable prompts, so any language isn't a problem.
■ Sysop replacable help screen for personnal look and feel {+}
■ Sysop replacable enter screen for personnal look and feel {+}
■ External Chat Utility support.
■ External Protocol support.
■ Log file support.
■ Multi-node support.
■ InterBBS support.
■ Unique Key System {+}
──────────────────────────────────────────────────────────────────────
Page 3
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
1.3 Requirements
The following requirements are necessary to run HiGHLANDER:
■ An IBM PC, XT, AT or 100% compatible PC with a hard disk.
■ Microsoft MS-DOS, IBM PC-DOS or DR-DOS version 3.30 or later.
■ A BBS system, though strictly speaking this is not a necessity.
■ At least 200KB of RAM available.
1.4 Testing
HiGHLANDER has been successfully tested with the following
configurations:
■ Systems equiped with Intel/AMD 80286, 80386, 80486 processors.
■ MS-DOS v5.0, v6.0, v6.2, and v6.22.
■ Microsoft Windows'95.
■ 4DOS v5.5.
■ Norton DOS.
■ Novell Netware Lite v1.1.
■ LANtastic v6.0
■ QuarterDeck DESQview v2.60, v2.61, v2.62, and v2.70
■ X00 v1.53a
■ BNU v1.70
HiGHLANDER has been successfully tested with the following external
chat utilities:
■ IceChat v3.80, v4.10, and v4.30
■ LightChat v1.10
HiGHLANDER has been successfully tested with the following external
protocol programs:
■ DSZ and GSZ
■ IceZmodem v1.02, and v1.10
■ Smodem v1.00
HiGHLANDER has been successfully tested with the following BBS
packages:
■ RemoteAccess v2.01, v2.02, and v2.50g1
■ PCBoard v15.21, and v15.22
■ Wildcat v4.00
■ Maximus v2.02
■ Telegard v2.99
──────────────────────────────────────────────────────────────────────
Page 4
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
1.5 License Agreement
"HiGHLANDER" refers to the executables and documentation contained
within the HiGHLANDER distribution archive, officially released by
Fonty Technologies (UK) Inc.
■ HiGHLANDER is Copyright (c) 1995, 96 Fonty Technologies (UK)
Inc. and may only be used in accordance with the conditions of
this License Agreement.
■ You may use HiGHLANDER for a period of thirty (30) days on a
trial basis in order to determine it's suitability for your
particular application. After this period you are required to
either register HiGHLANDER for each system you run or delete
the executable files from your system(s).
■ Registration entitles you to use HiGHLANDER and any future
versions of HiGHLANDER for as long as you wish, subject to any
licensing conditions attached to future versions.
■ Site and group registrations are available, and are dealt with
on a case by case basis.
■ You may not modify or reverse engineer the HiGHLANDER
executable in any way shape or form.
■ HiGHLANDER may not be used in any unlawfull or illegal manner.
■ You are encoraged to distribute the shareware version of
HiGHLANDER provided no fee is charged for it's distribution and
that the distribution archive is not modified in any way, shape
or form. Pay Bulletin Board Systems and Shareware libraries may
charge their normal fee provided no additional charge for
HiGHLANDER is levied.
■ HiGHLANDER shall not be included on any CD-ROM compilation
without prior arrangement and written permission of the
author(s). In the likely hood that permission is granted a
distribution and royalty fee will be charged by Fonty
Technologies (UK) Inc.
■ Fonty Technologies (UK) Inc. and the author(s) of HiGHLANDER
are under no obligation t o provide future versions of, or
support for HiGHLANDER.
■ Fonty Technologies (UK) Inc. and the author(s) of HiGHLANDER
will under no circumstance be held responsible for any damages
or loss that may or may not result from the use of HiGHLANDER.
■ By using HiGHLANDER you are agreeing to the conditions set out
in this License Agreement and are therefore releasing Fonty
Technologies (UK) Inc. and the author(s) of HiGHLANDER from
any liability or litigation.
──────────────────────────────────────────────────────────────────────
Page 5
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
1.6 Disclaimer
HiGHLANDER is provided "as is", without warranty of any kind or
fitness for a particular purpose, either expressed or implied, all of
are hereby explicitly disclaimed.
1.7 Guarantee
Fonty Technologies (UK) Inc. guarantee that HiGHLANDER will occupy
disk space. Any other guarantees are hereby removed.
1.8 Trademarks
All Fonty Technologies (UK) Inc. products are trademarks of Fonty
Technologies (UK) Inc. and Steven Holme. Other brands and product
names are trademarks of their respective holders.
Copyright (c) 1995, 96 Fonty Technologies (UK) Inc.
All rights reserved.
──────────────────────────────────────────────────────────────────────
Page 6
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
2 Registration
This software is NOT FREE. The unregistered version is distributed
as part of the "Shareware" concept for evaluation purposes and as
such, you are expected to register it within the evaluation period.
If, after this period, you decide not to use the software, you must
delete the executable files from your system(s) and not use it again
without prior registation.
What you get by registering:
■ No more annoying UNREGISTERED messages.
■ The ability to replace the internal "Enter Screen".
■ The ability to replace the internal "Help Screen".
■ Full technical support.
■ Free updates when available (no upgrade fee).
■ More chance of HiGHLANDER being developed further.
■ A personnalised registration key.
■ Statisfaction of supporting the "shareware" concept.
The basic registration fee is currently UKP 10. Site and group
registrations are dealt with on an individual basis.
To register, please read the REGISTER.FRM enclosed in the official
HiGHLANDER distribution archive.
──────────────────────────────────────────────────────────────────────
Page 7
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
3 Distribution Archive
The HiGHLANDER official distribution archive contains the following
files as part of it:
Badwords.Cfg - Example bad words configuration file.
BBS.Cfg - Example InterBBS configuration file.
Descript.ion - 4DOS Description file.
File_Id.Ans - ANSi Description file.
File_Id.Diz - Description file.
Highland.Bat - HiGHLANDER BBS batch file.
Highland.Cfg - Default configuration file.
Highland.Doc - This documentation.
Highland.Exe - The execuatable program.
InterBBS.Cfg - Example InterBBS league configuration file.
Register.Frm - Registration form.
Terms.Reg - Terms and conditions of registration.
Upgrade.Doc - Upgrade documentation
4 Additional Files
The following addition files for HiGHLANDER are available for download
or FREQ from The Fonty Towers BBS:
Filename FREQ name Description
----------------------------------------------------------------------
HANSI110.ARJ HIGHANSI HiGHLANDER Additional ANSi Screens.
──────────────────────────────────────────────────────────────────────
Page 8
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5 Installation
5.1 Quick Installation
The section briefly explains how to install HiGHLANDER. HiGHLANDER is
not particularly difficult to install and as such this is only a
quick guide.
I. Create a directory for HiGHLANDER to exist in,
e.g "C:\BBS\HIGHLAND".
II. Unarchive the HiGHLANDER distribution archive into this
directory.
III. At this point HiGHLANDER is ready to run. The next step is to
configure your BBS software to run HiGHLANDER. The following is
an example menu for RemoteAccess.
1 2 3 4 5 6 7
12345678901234567890123456789012345678901234567890123456789012345
;
*C /c \BBS\RA\HIGHLAND.BAT *N *M *UOneliner
Action Execute sub-program (Type 7)
Display
OptData
HotKey O
AutoExec No
Colour Colour example
IV. The only other task that remains is to create the batch file
which will actually run HiGHLANDER. The following is such an
example:
@ECHO OFF
CD \BBS\HIGHLAND
HIGHLAND.EXE /D C:\BBS /N %1 /SYSOP 64000 /WSEC 50 /DEC
CD \BBS
Please see the section on command line parameters for a more
detailed explanation on how to call HiGHLANDER.
──────────────────────────────────────────────────────────────────────
Page 9
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.2 Command Line Parameters
As with most door programs, HiGHLANDER has several command line
parameters. These parameters are as follows:
5.2.1 BBS Parameters
/D <path> - The path to the BBS drop file.
/N <node> - The node of the BBS that HiGHLANDER is
running on.
5.2.2 Communications Parameters
/ADDRESS <address> - Which com port address HiGHLANDER should
use. Note, only available when the
internal comms routines are being used.
/B <speed> - Tells HiGHLANDER what speed to
communicate with the modem at. When using
an unlocked fossil driver the value
should be: 300, 1200, 2400, 4800, 9600,
or 38400. If the fossil driver is locked
then the locked baud rate should be
passed.
When using the internal comms routines
the value should be any rate from 2 to
115,200 that evenly devides 115,200.
(i.e. 115200, 57600, 38400, 28800, 23040,
19200, 14400 12800, 9600 etc).
/NOFOSSIL - Specify not to use the FOSSIL driver.
/IRQ <irq> - Which IRQ the com port is assigned to.
Note, only available when the internal
comms routines are being used.
/NOFIFO - Tells HiGHLANDER not to use a 16550 UART
FIFO buffering.
/P <port> - Tells HiGHLANDER which com port should be
used. Note, only available when the
internal comms routines are being used.
──────────────────────────────────────────────────────────────────────
Page 10
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.2.3 HiGHLANDER Parameters
5.2.3.1 Standard Parameters
/AUTO - Detect the graphics capabilities of the
user's terminal automaticly.
/BAD <filename> - The full path and filename of the bad
words file.
/C <path> - The full path and filename of the
configuration file. This allows multiply
configuration files for multi-node
systems.
/DEC - Force HiGHLANDER to decrement the user's
number of messages written when deleting
a oneliner.
/DSEC <security> - Minimum security for the download
options.
/ESEC <security> - The minumum security needed to enter a
oneliner.
/HANDLES - Force HiGHLANDER to use the users handles
rather than full names.
/HELP or /? - Displays a list of all HIGHLANDER command
line arguments.
/HFILE <filename> - Specifies the full path and filename to
the help screen .ANS/AVT/RIP file.
/LOCAL - Force HiGHLANDER to run in local mode.
/MFILE <filename> - Specifies the full path and filename to
the main screen .ANS/AVT/RIP file.
/SYSOP <security - Minimum security for the sysop functions.
/TOP <number> - Tell HiGHLANDER how many top oneliner
writers to display. i.e. /TOP10.
/TSEC <security> - The minumum security needed to display
the date and time details.
/VSEC <security> - The minumum security needed to view the
bulletin files.
/WSEC <security> - The minumum security needed to display
the 'who wrote what' details.
5.2.3.2 Bulletin File Parameters
/WRITERSASC <path> - The full path and filename to the ASCII
top writers bulletin file.
/WRITERSANS <path> - The full path and filename to the ANSI
top writers bulletin file.
/WRITERSAVT <path> - The full path and filename to the Avatar
top writers bulletin file.
/NONASC <path> - The full path and filename to the ASCII
non writers bulletin file.
/NONANS <path> - The full path and filename to the ANSI
non writers bulletin file.
/NONAVT <path> - The full path and filename to the Avatar
non writers bulletin file.
──────────────────────────────────────────────────────────────────────
Page 11
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.3 The Configuration File
The following is a list of accepted keywords and parameters which may
exist within a HiGHLANDER configuration file:
5.3.1 BBS Commands
SysopName <name>
This is where you tell HiGHLANDER who the sysop is (normally you).
Only needed if the BBS's door information file (drop file) does not
speficy who the sysop is.
SystemName <bbs name>
This is how you tell HiGHLANDER the name of the BBS. Only needed if
the BBS's drop file does not specify the system name.
Node <node number>
This is normally only necessary if the node number is not contained
within the BBS's drop file.
BBSDir <path> Default: Current directory
BBS system directory. Indicates where the door information file can be
located.
5.3.2 Communications Related Commands
LockedBPS <speed>
This specifies the BPS rate at which HiGHLANDER should communicate
with the modem. This is only needed if the BBS's drop file does not
contain this information.
FossilPort <port>
Specifies the FOSSIL driver port number that the modem is connected
to. FOSSIL port 0 corresponds to COM 1, port 1 to COM 2, and so on.
This is only necessary if this information is not specified in the
BBS's drop file.
──────────────────────────────────────────────────────────────────────
Page 12
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.3.3 HiGHLANDER Related Commands
5.3.3.1 Standard Commands
DoorDir <path> Default: Current directory
HiGHLANDER's working directory. This is where all the HiGHLANDER data
files are stored.
LogFileName <full path> Default: Highland.Log
This option specifies the log file path and file name to use for
logging user activity.
DisableLogging <boolean> Default: Off
Prevents HiGHLANDER from writting to a log file.
MaximumDoorTime <seconds> Default: Time remaining on BBS
Maximum length of time a user is permitted to access HiGHLANDER.
InactivityTimeout <seconds>
How to tell HiGHLANDER what the inactivity timeout should be.
MainScreenFileName <path> Default: Highland
Specifies the full path and file name of the main screen .ANS/AVT/RIP
file. Do not include an extension if you wish to display different
files for different terminal graphics modes.
EnterScreenFileName<path> Default: HighHelp
Specifies the full path and file name of the enter screen .ANS/AVT/RIP
file. Do not include an extension if you wish to display different
files for different terminal graphics modes.
HelpScreenFileName <path> Default: HighHelp
Specifies the full path and file name of the main screen .ANS/AVT/RIP
file. Do not include an extension if you wish to display different
files for different terminal graphics modes.
TitleX <x position> Default: 18
Specifies the x position (column number) for the program title.
TitleY <y position> Default: 1
Specifies the y position (row number) for the program title.
──────────────────────────────────────────────────────────────────────
Page 13
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
TitleStyle <style> Default: Ice
Specifies the colour style that the program title, copyright message,
logo, oneliner entry box, and default help screen appear in. The
possible styles are:
Ice - Blues and White
Fire - Red, Yellow, and White
Fresh - Greens and White
Metal - Greys and White
Gothic - Purples and White
CopyrightX <x position> Default: 15
Specifies the x position (column number) for the copyright message.
CopyrightY <y position> Default: 22
Specifies the y position (row number) for the copyright message.
TotalLines <boolean> Default: On
Specifies whether or not the total number of oneliners written, is to
be displayed.
TotalLinesColour <colour> Default: Bright cyan on black
Specifies the colour of the total number of oneliners written field.
TotalLinesX <x position> Default: 74
Specifies the x position (column number) of the total number of
oneliners written field.
TotalLinesY <y position> Default: 15
Specifies the y position (row number) of the total number of oneliners
written field.
YourLines <boolean> Default: On
Specifies whether or not the users total number of oneliners written,
is to be displayed.
YourLinesColour <colour> Default: Bright cyan on black
Specifies the colour of the users total number of oneliners written
field.
YourLinesX <x position> Default: 74
Specifies the x position (column number) of the users total number of
oneliners written field.
──────────────────────────────────────────────────────────────────────
Page 14
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
YourLinesY <y position> Default: 16
Specifies the y position (row number) of the users total number of
oneliners written field.
Percentage <boolean> Default: On
Specifies whether or not the percentage is to be displayed.
PercentageColour <colour> Default: Bright cyan on black
Specifies the colour of the "% of users logging on today have written
a message" field.
PercentageX <x position> Default: 54
Specifies the x position (column number) of the "% of users loggin on
today have written a message" field.
PercentageY <y possition> Default: 16
Specifies the y position (row number) of the "% of users logging on
today have written a message" field.
OnelineForegroundColour <colour> Default: White
Specifies the foreground colour in which the oneliners appear. If the
<colour> field contains "Pattern", or "Random" then the colour of each
oneliner will either follow a preset pattern or be generated randomly.
If the <colour> field contains "UserSelect" then the user will be
able to select their prefered colour via a light bar menu selector.
OnelineBackgroundColour <colour> Default: Black
Specifies the background colour in which the oneliners appear.
OnelineX <x position> Default: 2
Specifies the x position (column number) of the oneliners.
OnelineY <y position> Default: 2
Specifies the starting y position (row number) of the oneliners.
QuoteForegroundColour <colour> Default: Bright black
Specifies the foreground colour in which the quote marks around the
oneliner appear.
QuoteBackgroundColour <colour> Default: Black
Specifies the background colour in which the quote marks around the
oneliner appear.
──────────────────────────────────────────────────────────────────────
Page 15
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
DeleteForegroundColour <colour> Default: White
Specifies the foreground colour in which any deleted oneliners appear.
DeleteBackgroundColour <colour> Default: Black
Specifies the background colour in which any deleted oneliners appear.
TopTableLength <length> Default: 10
Specifies the length of the top oneliner writers.
TopTableColour <colour> Default: Bright cyan on black
Specifies the colour of the "number of messages written" in the top
table.
TopTableX <x possition> Default: 75
Specifies the x position (column number) of the "number of messages
written" in the top table.
TopTableY <y possition> Default: 3
Specifies the starting y position (row number) of the "number of
messages written" in the top table.
NamesColour <colour> Default: Bright cyan on black
Specifies the colour of the names within the top table. Please note,
that whether 'bright' is used or not, the 1st name in the top table
will appear bright and all others dull.
NamesX <x possition> Default: 57
Specifies the x position (column number) of the names within the top
table.
NamesY <y possition> Default: 3
Specifies the starting y position (row number) of the names within the
top table.
PromptX <x possition> Default: 1
Specifies the x position (column number) of the main prompt.
PromptY <y possition> Default: 23
Specifies the y position (row number) of the main prompt.
EnterPromptY <y possition> Default: 8
Specifies the y position (row number) of the enter oneliner prompt.
──────────────────────────────────────────────────────────────────────
Page 16
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
EnterOnelinerY <y possition> Default: 12
Specifies the y position (row number) of where user input of the
oneliner takes place.
SelectProtocolTitleText <text> Default: Select Protocol
Specifies the select protocol title.
SelectProtocolTitleColour <colour> Default: Blue on black
Specifies the colour of the select protocol title.
SelectProtocolPromptText <text> Default: Select:
Specifies the select protocol prompt.
SelectProtocolPromptColour <colour> Default: Blue on black
Specifies the colour of the select protocol prompt.
EnterPromptText <text> Default: Enter your Oneliner below
Specifies the enter oneliner prompt.
EnterPromptColour <colour> Default: Bright cyan on black
Specifies the colour of the delete oneliner prompt.
BoxTop <possition> Default: 14
Specifies the top most row number of the box which is cleared if a
user doesn't enter a oneliner, and says "Perhaps next time!". This is
normally over the copyright and total messages information.
BoxLeft <possition> Default: 52
Specifies the left most column number of the box which is cleared if
a user doesn't enter a oneliner.
BoxBottom <possition> Default: 21
Specifies the bottom most row number of the box which is cleared if a
user doesn't enter a oneliner.
BoxRight <possition> Default: 79
Specifies the right most column number of the box which is cleared if
a user doesn't enter a oneliner.
Handles <boolean> Default: False
Allows the sysop to specify whether or not handles are to be used
instead of user's full names.
──────────────────────────────────────────────────────────────────────
Page 17
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
DecUserOnDelete <boolean> Default: False
Specfies whether or not the number of oneliners a user has written, is
to be decremented when the sysop deletes a oneliner.
BadWordsFile <path> Default: BadWords.Cfg
Allows the specifing of a bad words list file. This list will be used
to check the users oneliners for any bad words.
AnimatedPrompts <boolean> Default: On
Allows the enabling/disabling of the animated prompt on the help
screen.
ChatUtility <command line> Default: Blank
Specifies the command line to execute an external chat utililty. When
this field is blank the internal chat functions will be used.
FreezeChatTimer <boolean> Default: Off
Allows the enabling/disabling of the chat timer during an external
chat program.
UnknownBBSText <text> Default: Unknown BBS
Text to be displayed when the BBS origin of a oneliner is unknown.
UnknownWriterText <text> Default: Unknown Writer
Text to be displayed when the writer of a oneliner is unknown.
UnknownMessageText <text> Default: Unknown Oneliner
Text to be displayed when the oneliner message is unknown.
CheckingNetmailText <text> Default: Checking Netmail for
InterBBS messages
Specifies the text to be displayed when HiGHLANDER is checking the
netmail directory for interBBS messages.
ProcessingInterBBSText <text> Default: Processing InterBBS
message
Specifies the text to be displayed when HiGHLANDER is processing
interBBS messages.
NoNewInterBBSText <text> Default: No new InterBBS messages
Specifies the text to be displayed when HiGHLANDER can not find any
new interBBS messages.
──────────────────────────────────────────────────────────────────────
Page 18
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.3.3.2 Security Commands
EnterSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
enter a oneliner.
ViewBBSSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
view the BBS origin of each oneliner.
ViewDateTimeSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
view the date and time of each oneliner.
ViewWriterSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
view the writer of each oneliner.
ViewBulletinSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
view the bulletin files.
DownloadBulletinSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
download the bulletin files.
ChangeProtocolSecurity <sec level> Default: 0
This specifies what the user's security level needs to be in order to
change their protocol settings.
SysopSecurity <sec level> Default: 64000
This specifies what the user's security level needs to be in order to
access the sysop functions.
──────────────────────────────────────────────────────────────────────
Page 19
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.3.3.3 Menu Commands
YesKey <character> Default: y
Specifies the user input keyboard character to enter a oneliner.
NoKey <character> Default: n
Specifies the user input keyboard character to quit HiGHLANDER.
ViewBBSKey <character> Default: b
Specifies the user input keyboard character to display the BBS origin
for each oneliner.
ViewDateTimeKey <character> Default: t
Specifies the user input keyboard character to display the date and
time for each oneliner.
ViewWriterKey <character> Default: w
Specifies the user input keyboard character to display the writer of
each oneliner.
ViewBulletinKey <character> Default: v
Specifies the user input keyboard character to display the bulletin
files.
DownloadBulletinKey <character> Default: d
Specifies the user input keyboard character to enable the user to
download the bulletin files.
ChangeProtocolKey <character> Default: p
Specifies the user input keyboard character to allow the user to
change their protocol settings.
HelpKey <character> Default: ?
Specifies the user input keyboard character to display the help page.
ReplaceKey <character> Default: r
Specifies the user input keyboard character to access the replace
function. Note, this is only available to users with a security level
greater, or equal to that of the specified sysop security level.
──────────────────────────────────────────────────────────────────────
Page 20
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
DeleteKey <character> Default: e
Specifies the user input keyboard character to access the delete
function. Note, this is only available to users with a security level
greater, or equal to that of the specified sysop security level.
MenuPromptText <text> Default: Choose your option
Specifies the text for the main menu prompt.
MenuPromptColour <colour> Default: Blue on black
Specifies the colour of the main menu prompt.
MenuOptionsColour <colour> Default: Bright blue on black
Specifies the colour of the options which appear at the end of the
main menu prompt.
ViewBulletinPromptText <text> Default: Which Bulletin do you want
to view?
Specifies the view bulletin prompt.
ViewBulletinPromptColour <colour> Default: Blue on black
Specifies the colour of the view bulletin prompt.
ViewBulletinOptionsColour <colour> Default: Bright blue on black
Specifies the colour of the options that appear at the end of the
view bulletin prompt.
DownloadBulletinPromptText <text> Default: Which Bulletin do you want
to download?
Specifies the download bulletin prompt.
DownloadBulletinPromptColour <colour> Default: Blue on black
Specifies the colour of the download bulletin prompt.
DownloadBulletinOptionsColour <colour> Default: Bright blue on black
Specifies the colour of the options that appear at the end of the
download bulletin prompt.
ReplacePromptText <text> Default: Which Oneliner do you want
to replace?
Specifies the replace oneliner prompt.
──────────────────────────────────────────────────────────────────────
Page 21
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
ReplacePromptColour <colour> Default: Blue on black
Specifies the colour of the replace oneliner prompt.
ReplaceOptionsColour <colour> Default: Bright blue on black
Specifies the colour of the options that appear at the end of the
replace oneliner prompt.
DeletePromptText <text> Default: Which Oneliner do you want
to delete?
Specifies the delete oneliner prompt.
DeletePromptColour <colour> Default: Blue on black
Specifies the colour of the delete oneliner prompt.
DeleteOptionsColour <colour> Default: Bright blue on black
Specifies the colour of the options that appear at the end of the
delete oneliner prompt.
5.3.3.4 Bulletin Commands
TopWritersAsciiBulletinFile <path> Default: Writers.Asc
This option specifies the name and location of the Top Writers ASCII
Bulletin File which will be written when HiGHLANDER exits.
TopWritersAnsiBulletinFile <path> Default: Writers.Ans
This option specifies the name and location of the Top Writers ANSI
Bulletin File which will be written when HiGHLANDER exits.
TopWritersAvatarBulletinFile <path> Default: Writers.Avt
This option specifies the name and location of the Top Writers Avatar
Bulletin File which will be written when HiGHLANDER exits.
NonWritersAsciiBulletinFile <path> Default: !Writers.Asc
This option specifies the name and location of the Non Writers ASCII
Bulletin File which will be written when HiGHLANDER exits.
NonWritersAnsiBulletinFile <path> Default: !Writers.Ans
This option specifies the name and location of the Non Writers ANSI
Bulletin File which will be written when HiGHLANDER exits.
──────────────────────────────────────────────────────────────────────
Page 22
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
NonWritersAvatarBulletinFile <path> Default: !Writers.Avt
This option specifies the name and location of the Non Writers Avatar
Bulletin File which will be written when HiGHLANDER exits.
The following is a list of the field colours which apply to the Top
Writers bulletin file:
TopWritersTitleColour Default: Bright yellow on black
TopWritersTitleUnderlineColour Default: Bright white on black
TopWritersMainUnderlineColour Default: Bright red on black
TopWritersUsernameTitleColour Default: Bright white on black
TopWritersOnelinersTitleColour Default: Bright white on black
TopWritersUsernameColour Default: Bright green on black
TopWritersOnelinersColour Default: Bright cyan on black
The following is a list of the field colours which apply to the Non
Writers (users that have not writen any oneliners) bulletin file:
NonWritersTitleColour Default: Bright yellow on black
NonWritersTitleUnderlineColour Default: Bright white on black
NonWritersMainUnderlineColour Default: Bright red on black
NonWritersUsernameTitleColour Default: Bright white on black
NonWritersUsernameColour Default: Bright green on black
GeneratingTopWritersASCIIText <text> Default: Generatring Top Writers
ASCII Bulletin
Specifies the text displayed when generating the top writers ASCII
bulletin file.
GeneratingTopWritersANSIText <text> Default: Generatring Top Writers
ANSI Bulletin
Specifies the text displayed when generating the top writers ANSI
bulletin file.
GeneratingTopWritersAVTText <text> Default: Generatring Top Writers
Avatar Bulletin
Specifies the text displayed when generating the top writers avatar
bulletin file.
──────────────────────────────────────────────────────────────────────
Page 23
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
GeneratingNonWritersASCIIText <text> Default: Generatring Non Writers
ASCII Bulletin
Specifies the text displayed when generating the non writers ASCII
bulletin file.
GeneratingNonWritersANSIText <text> Default: Generatring Non Writers
ANSI Bulletin
Specifies the text displayed when generating the non writers ANSI
bulletin file.
GeneratingNonWritersAVTText <text> Default: Generatring Non Writers
Avatar Bulletin
Specifies the text displayed when generating the non writers avatar
bulletin file.
TopWritersASCIIBulletin <boolean> Default: On
Specifies whether to generate the top writers ASCII bulletin file.
TopWritersANSIBulletin <boolean> Default: On
Specifies whether to generate the top writers ANSI bulletin file.
TopWritersAVTBulletin <boolean> Default: On
Specifies whether to generate the top writers avatar bulletin file.
NonWritersASCIIBulletin <boolean> Default: On
Specifies whether to generate the non writers ASCII bulletin file.
NonWritersANSIBulletin <boolean> Default: On
Specifies whether to generate the non writers ANSI bulletin file.
NonWritersAVTBulletin <boolean> Default: On
Specifies whether to generate the non writers avatar bulletin file.
──────────────────────────────────────────────────────────────────────
Page 24
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.3.3.5 Protocol Commands
In order to add download capabilities to HiGHLANDER there are three
protocol commands, which you need to use in the configuration file,
for each protocol you add. It is possible to use a maximum of 255
protocols with HiGHLANDER.
Please note, that in the following list of commands 'X' (without
quotes) represents a number from 1 to 255.
ProtocolXKey <character> e.g: Z
Specifies the user key press in order to select the given protocol.
ProtocolXCommandLine <command line> e.g: GSZ.EXE port *P *F
This command specifies the command line and arguments necessary to
execute the external protocol. Please note, in order to specify the
communications port, baud rate, node number and filename the following
macros are used:
*B Baud Rate
*C Com Port (1 based COM Port)
*N Node Number
*P Fossil Port (0 based COM Port)
*F Filename
ProtocolXDescription <description> e.g: Zmodem
This option specifies the title of the given protocol.
5.3.6 A Note On The Colour Parameters
The colour parameters are not (as most of you will probably expect)
required to be complicated numerical values, which have to be
calculated depending on what background colour you have. In fact all
colour parameters can be specified in english. The following is an
example list of valid colour parameters:
Bright white on black
Bright red on black
Bright blue on blue
Bright black on black (Necessary to get dark grey on black)
Red on green
Cyan on yellow
──────────────────────────────────────────────────────────────────────
Page 25
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
5.4 InterBBS configuration files
In order to run HiGHLANDER in interbbs mode you must have two
configuration files setup which detail your bbs settings and the other
member boards within the league.
The InterBBS.Cfg file specifies all nodes within the league. It is the
responsibility of the league coordinator (node 1) to update and
distribute this file when necessary.
InterBBS.Cfg is as follows:
<node>
<bbs name>
<bbs ftn address>
<city>
<state code>
<country code>
<blank line>
This must be repeated for each BBS within the league. An example
InterBBS.Cfg follows:
1
The Fonty Towers BBS
2:2503/201
Nottingham
UK
2
Your BBS name
Your BBS node address
Your location
UK
Note, the state and counry codes must each be 2 characters. ie.
US - United States of America
UK - United Kingdom
FR - France
CA - California
NY - New York
OH - Ohio
──────────────────────────────────────────────────────────────────────
Page 26
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
The BBS.Cfg file details your own BBS's settings. The format of this
file follows:
<sysop name>
<bbs name>
<bbs node address>
<inbound mailer directory>
<netmail directory>
<league number>
<mailer>
Note, the only mailer supported at the moment is "FrontDoor".
An example BBS.Cfg file follows:
Steven Holme
The Fonty Towers BBS
2:2503/201
E:\INBOUND
E:\NETMAIL
1
FRONTDOOR
5.5 Maintanence
Unlike alot of BBS door programs, HiGHLANDER does not require a
seperate program to be ran in the BBS's nightly maintanence. All
necessary maintanence is carried out when HiGHLANDER is ran as a door.
However, If HiGHLANDER is being ran in interBBS mode is is recommended
that HIGHLANDER /MAINT is ran within your mail processing batch files.
──────────────────────────────────────────────────────────────────────
Page 27
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
6 Future Versions
The following list describes some of the enhancements that Fonty
Technoloies (UK) Inc. have planed for future versions of HiGHLANDER:
■ Macro replacement - Allow replacement of %USER%, @USER@,
%LOCATION%, styled macros.
■ Support for route.cfg - Allow interBBS packets to be routed by
HiGHLANDER.
■ Generate interbbs.cfg - Automatic generation of InterBBS.Cfg.
Which would be sent to all BBSes within
the league via netmail.
■ InterBBS statistics - Allow the user to view statistics for
interBBS activity.
■ RIP Graphics - Add support for RIP graphics.
■ LightBars - Depending on user response on this one,
I would like to add support for
LightBar controls.
If you have any suggestions for future releases of HiGHLANDER then
please drop us a line and let us know your ideas.
7 Credits
The HiGHLANDER oneliner door program and it's documentations was
written by Steven Holme.
HiGHLANDER distribution, registration and support services are
provided by Steven Holme.
Testing and evaluation of HiGHLANDER is provided by the Fonty
Technologies Inc. beta team.
All executables and documentation contained in the HiGHLANDER
distribution archive are Copyright (c) 1995, 96 Fonty Technologies
(UK) Inc. All rights reserved.
──────────────────────────────────────────────────────────────────────
Page 28
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
7.1 Thanks
The author(s) of HiGHLANDER would like to personnally thank the
following persons (in no particular order):
Lee Dunlin, Dream Line BBS - For making Steven Holme the Amiga CoSysop
of Dream Line BBS from Feburary 1994 to
September 1994 for without this The Fonty
Towers BBS would niether have been
started or exist. Also for his help and
support in starting The Fonty Towers BBS.
Unfortunately Dream-Line BBS has now
closed nodes 2, 3 and 4.
Jay7, The Diamond Line BBS - For the initial idea of HiGHLANDER.
Aardvark@innotts.co.uk - For distributing this program on the net.
Deborah Hunt (Ex-Fiance) - For her time and patience with Steven
whilst writing this software and running
the BBS. Unfortunately her patience ran
out! :-(
Andrew Milner - For RemoteAccess BBS software.
Brian Pirie - For the OpenDoors BBS Door programming
Toolkit. HiGHLANDER was developed with
OpenDoors v5.00 and v6.00.
D-ViBE / REBELS - For the general idea of what a oneliner
program should look like and consist of.
7.2 Contributions
The following persons have contributed ideas for HiGHLANDER:
Simon Groom
Mike Smith
Andy Sayers
Jonathan Irvine
Craig Cunningham
The following persons have contributed ANSi screens:
Craig Cunningham of PUBBS: Outer Limits
──────────────────────────────────────────────────────────────────────
Page 29
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
7.3 The Beta Testers
The Fonty Technologies (UK) Inc. beta team consists of the following
persons:
Dwayne Heaton Virtual Maddness BBS +44-1344-422575
FidoNet: 2:252/314
RANet: 73:7441/13
Craig Cunningham PUBBS: Outer Limits +44-115-974-6427
FidoNet: 2:2503/210
RANet: 73:7444/210
Ross Bamford The Freight Train BBS +44-115-NOW-DOWN
FidoNet: 2:2503/109
RANet: 73:7444/109
Michal Nguyen PC's Comp Tech USA BBS +1-214-357-5613
Tom De Puysseleyr Braindeath BBS +32-3-4542902
FidoNet: 2:292/8125
All the users of The Fonty Towers BBS for beta testing all releases of
HiGHLANDER.
If you would like to become a beta tester then please contact Fonty
Technologies stating why, and what you can offer in terms of a testing
environment.
7.4 InterBBS Leagues
The following is a list of all known HiGHLANDER leagues. If you would
like your league including please mail your details, including a list
of all the member systems, to Fonty Technologies (UK) Inc.
League Coordinator Node System Net address
----------------------------------------------------------------------
1 Steven Holme 01 The Fonty Towers BBS 2:2503/201
02 PUBBS: Outer Limits 2:2503/210
──────────────────────────────────────────────────────────────────────
Page 30
HiGHLANDER v2.00 Documentation
──────────────────────────────────────────────────────────────────────
8 Support
If you need help, information or technical support, or would like to
apply as a beta tester then please contact us using one of the methods
listed below:
8.1 By Post
Fonty Technologies (UK) Inc.
97 Plains Road
Mapperley
Nottingham
NG3 5QT
ENGLAND
8.2 By BBS
The Fonty Towers BBS
-=-=-=-=-=-=-=-=-=-=
Node 1: +44-115-952-7443 USR Courier 33,600bps
Node 2: +44-115-955-3402 Trust 14,400bps
Node 3: +44-115-955-3426 Trust 14,000bps
Node 4: +44-115-955-4440 Trust 14,000bps
8.3 By E-Mail
For support by E-Mail please Netmail "Steven Holme" at one of the
following networks:
FidoNet: 2:2503/201, 201, 201, 201 (Nottingham HUB)
DiamondNet: 52:5210/101, 102, 103, 104 (UK RC)
RANet: 73:7444/201, 202, 203, 204 (Net 7444 NC)
TrekNet: 107:1713/201, 202, 203, 204 (Net 1713 NC)
IncarNet: 153:175/201, 202, 203, 204 (Nottingham HUB)
MercuryNet: 240:290/201, 201, 203, 204 (Net 290 NC)
FABNet: 1995:17/201, 202, 203, 204
BBSNet: 405:130/2
UFONet: 405:130/2
InterNet: kewlkat@innotts.co.uk
steven.holme@fonty.coastmnl.co.uk
steven.holme@helpdesk.kingston-net.co.uk
──────────────────────────────────────────────────────────────────────
Page 31
HiGHLANDER 2.00 Documentation
──────────────────────────────────────────────────────────────────────
9 Contributions
If any person using this product, designs their own 'Main Screen' with
configuration file and would like to have their efforts distributed
with future releases of HiGHLANDER then please send your work to
Fonty Technologies (UK) Inc. at any of the above addresses.
You will be credited in the HiGHLANDER documentation for your work.
Additionally, help with any of future features of HiGHLANDER will be
greatfully received.
10 And On a Last Note
Thank you for trying HiGHLANDER.
\\||//
[ _ _ ]
..
____
──────────────────────────────────────────────────────────────────────
Page 32